home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / os2 / pccts.zip / FILELIST < prev    next >
Text File  |  1992-12-08  |  7KB  |  245 lines
  1.  
  2.      This document lists the  items  available  from  the  PCCTS  mail
  3. server.   The typical user with ftp access will ftp "pccts.bag" (which
  4. contains all source code) README, UPDATE106.txt and install.   If  the
  5. user  has troff and friends (-ms package, pic, tbl) "manual.ms" can be
  6. ftp'd.  Otherwise, a PostScript version, "manual.ps", or a  text  ver-
  7. sion without figures, "manual.txt", is available.  The individual bags
  8. like "antlr.bag" are offered so that updates to those packages can  be
  9. obtained  without  grabbing the whole PCCTS bag.  To install, read the
  10. README text file.  The ftp address is given at the end of  this  docu-
  11. ment.
  12.  
  13.      Users without ftp access must ask the mailbot to email  the  same
  14. files  that you would ftp if you had the capability; i.e. "pccts.bag",
  15. README, install and "manual.ms", "manual.ps"  or  "manual.txt".   This
  16. can be done from UNIX via:
  17.  
  18. "mail -s 'email pccts.bag' pccts@ecn.purdue.edu"
  19.  
  20. which requests that the entire PCCTS source be mailed to you in  small
  21. chunks.   The README, install and manual files are obtained in a simi-
  22. lar fashion.
  23.  
  24. The small mail chunks are put back together with  "one.c"  which  must
  25. also  be  obtained  from  the  mailbot  (and does not itself arrive in
  26. chunks).  The files (which where broken up) are reconstructed with the
  27. executable  obtained  via  "cc -o one one.c".  See the README file for
  28. more details.
  29.  
  30.      The following items are currently available from pccts:
  31.  
  32. README
  33.      Describes installation and  some  of  differences  between  beta-
  34.      release PCCTS and PCCTS 1.0.
  35.  
  36. UPDATE106.ms
  37.      This TROFF document describes the update of PCCTS  from  1.00  to
  38.      1.06.   As  the  manual  has  NOT  changed,  this serves as a new
  39.      feature list.  BUGS100 describes the bugs found in 1.00 that were
  40.      fixed  for  1.06.   PostScript and text versions of this file are
  41.      also available.
  42.  
  43. install
  44.      An 'sh' script that can be used by UNIX users to  install  PCCTS.
  45.      This script builds a directory hierarchy, unbags all source files
  46.      and creates the antlr (ANother Tool for Language Recognition) and
  47.      dlg (DFA-based lexical analyzer generator) executables.
  48.  
  49. one.c
  50.      C program that combines chunks of files  back  into  an  original
  51.      file.  Large files are broken down into bite-size chunks suitable
  52.      to the mailer.  This program can be used to reverse the splitting
  53.      process.  Any files that arrive with a subject line indicating it
  54.  
  55.  
  56.  
  57.                                                                 Page 1
  58.  
  59.                                                                  PCCTS
  60.  
  61.  
  62.      is a chunk, must be combined using one.  It may be compiled  with
  63.      "cc -o one one.c".  See the README file for details.
  64.  
  65. BUGS  Gives a current list of bugs that we are aware of in  the  PCCTS
  66.      in  1.06.   Sometimes  a  bug fix is given along with the problem
  67.      description.  This file is updated occasionally.  If you  have  a
  68.      problem check this file before sending in a bug report.
  69.  
  70. BUGS100
  71.      A list a bugs found in PCCTS 1.00 that have been fixed for 1.06.
  72.  
  73. unbag.c
  74.      PCCTS source files arrive in  "bags"  which  are  collections  of
  75.      other  files  (which  could  be  other  bags), hence they need to
  76.      "unbagged" to recover the contents.  This can be done  either  by
  77.      executing the bag as a shell command (just like unpacking a trad-
  78.      itional shell archive; e.g. 'sh pccts.bag') or by using the  pro-
  79.      gram  unbag.   The  unbag  program does not destroy the input bag
  80.      file.  Normally, the user does not need to explicitly unbag  any-
  81.      thing.   The install script handles everthing.  unbag may be com-
  82.      piled with "cc -o unbag unbag.c".
  83.  
  84. manual.ms
  85.      TROFF source of the PCCTS reference manual.   This  file  may  be
  86.      printed using troff -ms & friends (pic, tbl).
  87.  
  88. manual.ps
  89.      A PostScript version of manual.ms.
  90.  
  91. manual.txt
  92.      A raw text version of manual.ms.
  93.  
  94. begtut.ms,
  95.      A beginners tutorial of PCCTS.  It is suggested that this file be
  96.      placed  in  a  subdirectory  of  your PCCTS directory at the same
  97.      level of antlr, dlg etc..
  98.  
  99. advtug.bag
  100.      A tutorial for advanced language developers unfamiliar with PCCTS
  101.      or  for  those who want to learn more.  A "compiler" is developed
  102.      for a simple stack machine.  This is a much better example of how
  103.      to  use  the abstract-syntax-tree (AST) mechanism than the refer-
  104.      ence  manual  (whose  description  is  terse  and  is  not   well
  105.      presented).   This  bag  contains  the TROFF, PostScript and text
  106.      version of the documentation; all examples are already  extracted
  107.      from  the  document  and are ready to play with.  It is suggested
  108.      that this file be placed in a subdirectory of your  PCCTS  direc-
  109.      tory at the same level of antlr, dlg etc..
  110.  
  111. pccts.1, pccts1.txt
  112.      PCCTS man page (view with "troff -man pccts.1") and text  version
  113.      of manual page.
  114.  
  115. antlr.1, antlr1.txt
  116.  
  117.  
  118.  
  119.                                                                 Page 2
  120.  
  121.                                                                  PCCTS
  122.  
  123.  
  124.      ANTLR man page (view with "troff -man antlr.1") and text  version
  125.      of manual page.
  126.  
  127. dlg.1, dlg1.txt
  128.      DLG man page (view with "troff -man dlg.1") and text  version  of
  129.      manual page.
  130.  
  131. pccts.bag
  132.      Complete C source  code  for  latest  PCCTS  release.   Contains:
  133.      antlr.bag,  dlg.bag,  h.bag,  genmk.c,  set.bag,  sym.bag, C.bag,
  134.      pascal.bag, rexpr.bag.  If you get this file, you do NOT need  to
  135.      get the individual bag files that comprise this one.
  136.  
  137. antlr.bag
  138.      C source code for antlr -- ANother Tool for Language Recognition.
  139.  
  140. dlg.bag
  141.      C source code for dlg -- DFA-based lexical analyzer generator.
  142.  
  143. h.bag
  144.      C source of the PCCTS include files.
  145.  
  146. genmk.c
  147.      A C file that creates PCCTS makefiles from a project name  and  a
  148.      list  of grammars; e.g. genmk t t.g makes a makefile that creates
  149.      an executable called t from a grammar file t.g.
  150.  
  151. set.bag
  152.      C source code for a dynamically-allocated bit-set manager.   This
  153.      is used by both antlr and dlg and is needed for them to compile.
  154.  
  155. sym.bag
  156.      C source for a symbol table manager with arbitrary scoping  capa-
  157.      bilities.
  158.  
  159. C.bag
  160.      The C grammar is really part of a program that can generate func-
  161.      tion and variable prototypes from a C source file.
  162.  
  163. pascal.bag
  164.      Grammar for ISO PASCAL with symbol table management.
  165.  
  166. rexpr.bag
  167.      C source for the function
  168.  
  169.           rexpr(char *expr, char *s)
  170.  
  171.  
  172.      which answers whether s is in the language described by the regu-
  173.      lar expression expr.
  174.  
  175.      All  PCCTS  files  are   available   via   anonymous   ftp   from
  176. marvin.ecn.purdue.edu    (128.46.179.151)    in    the    subdirectory
  177. pub/pccts/1.06  (beginning  December  1,  1992);  the  ftp  login   is
  178.  
  179.  
  180.  
  181.                                                                 Page 3
  182.  
  183.                                                                  PCCTS
  184.  
  185.  
  186. "anonymous" and has a password of your email address.
  187.  
  188. Thank you for your interest,
  189.  
  190.         The Authors of The Purdue Compiler Construction Tool Set
  191.  
  192.     Terence J. Parr, parrt@ecn.purdue.edu
  193.     Will E. Cohen,   cohenw@ecn.purdue.edu
  194.     Henry G. Dietz,  hankd@ecn.purdue.edu
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.                                                                 Page 4
  244.  
  245.